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1,0 Introduction 

PEEK is a utility program designed to oterate under the ITS 
tin sharing system. It enables a user to monitor a variety of 
aspects of the time sharing system ty providing periodically 
updated display outjut cr periodic printed output tc teletype or 
line printer. 

Just what information is being presented to the user is 
conrolled by PELK's information mode. The availabile modes are 
listed in section 3 below. Section b describes how PEEK determines 
which device to outjut en- Section 2 describles, in general , how 
the user car input commands to PEEK. 

The first line cf all pages output by PEEK is as follows: 

VXL xxx PEEK yyy mm/dri/yy hh:mm:s£ S1IME=DD:HH:HM:SS 

In this line xxx is the version nuater cf the systeiu in use and yyy 
is the version number ol the PEEK in use (so bugs can be matched to 
the exact version)* At the time this memo was released, PEEK 253 
was the version in use. DD:HH:MM:St is the length of tine that the 
particular VIS system running has been up and ma/dd/yy hh:mm:ss is 
the current date and tine according to ITS. 

For (tanv modes (those with the code letter Just after the 
Eut-seciion nuiuler underlined in sectior 3) a standard second line 
ir cutptt for any cere or disk memory error. This line lists the 
following ttxee errors if any have cccured: 

1* Irrecoverable disk errors, 

2. Core aero* ry tarity errorr* 

3. Core memory failures to respond (HXM). 

The last line ol all pafes outptt to the 34C display ty 
PEfci. is a list of node command letters which can be piven bv lifht 
|cm in£ theiL (this lias the same effect as typing them would J. 
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2.0 Command Format;- 

PEEK is an unusual jrograiB in that it immediately 
interprets all characters typed at it at the interrupt level. 
Cowandf to PEEK are all single letters or control characters, 
hojli times preceded by a nu&eric argument. The commends listed in 
sections 5 &nd 6 of this' memo take effect immediately and dc not 
affect any number that IEEK may be accumulating froni difits typed 
intc it. 

The commands lifted in section ; change PEEK's information 
mode. Ihey may or L*ay rot r^ake use of a numeric argument but all 
■ ; ■ i any number PEEK may have accumulated. These commands 
normally start PEEK iratdiately disjlaylng the infojTiation 
requested, 

PEEK interprets digits typec at it as tongue ^ octal 
nujuler. 
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J.Q Information Modes /.valuable 

Below are listec all the different information modes of 
I'tEK. Normally, the information specified by the current 
information node is out]ut to the currently selected output device 
(set section 5). After PEEK has dor.e this it waits a while and 
the* rejeats- This wailing period is fixed at ten seconds for pome 
iniermation modes that display information that is not expected to 
charge. For most modes, the waiting time is initially tenseconds 
hut can be changed ty the Z command (see section 6). 

3-1 A ARPA Network Sockets 

The active ARPA network sockets and pseudo-teletypes in the 
system are listed by this mode. After a heading line, cneline of 
information is piven for each socket with the following 
information: (1) the socket's logical index number; (2) the index. 
UNA1-E and JNAKE of the user associated with the socket: (3) the 
locil socket number and the state oi the socket; {40 the foreign 
host ano socket numter associated with the socket; (5) the 
cut; tending message and bit allocations on the socket. 

If any pseudo-teletypes (STY) are in use, they are listed 

belf.w all the sockets urder a different heading line. On each line 

is jisted the following: (1) the user index, UIJAME and JNAKE of 

the procedure that has the i/TY open as a teletype; (2) the teletvae 
numler of the STY- (3) m© UMAHE of the Job tha £ ^ £ he oth g*° 

of the STY open. 

J. 2 C Lisk Channels 

This mode lists the channel? actually in use for the 
transfer of information between disk fiJes and procedures. After 
an explanatory reading ]ine f one lire ir. displayed for each charnel 
with the following information: (1) the lofical channel number; 
(2) the index, UNAME and JNAME of the user procedure that has the 
chainel open; Q J various status letters as listed in the next 
partgraph; {A) a count of the numter of words transferred: (5) 
the system name and two file names of the file. 

The following are the disk transfer status letters that can 
appear in the disk channels mode output: 

A File address altered by .ACCESS or not. 

B Core transfer hung on active buffer. 
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E Transfer har reached EOF. 

P Hunt in directory full. 

L Channel locked* 

H Master directory read. 

P PDUI-iP mode transfer. 

R Read. 

T Track Usage Table read* 

U User directory read. 

V Write. 

? Parity error on read. 

* Delete file when channel closed. 

5-3 D lisk Directory 

This mode displays the disk juaster file directory ("H.F.D. 
(niE)*)| which lists the names of ell the user directories, and 
thei lifts the user directory {".FILE. (DIR) W ) for the current 
default systeia name associated with PEEK. If output is to the ZAO 
difijlay, it may be possible to change this default syst< -\ name by 
lifht pennin£ one of the names in the rmster directory display. 

?.4 fcwap/Schedule Variables 

This mode displays information very similar to mode K with 
certain additioral data related to the ITS scheduler & Fwaprinp 
routines. In particular, the interrupt request words in the per 
job information are replaced by the number of pa^e swap in requests 
and the total run time used is replaced by the average recert lead 
represented by the job in pbE©-^illi£ecends. 

In addition, an extra line is displayed for each to; level 
job showing the average percent of machine time used ant 1 the load 
in J age-milliseconds for the tree topped by that job (but note that 
all disowned jobs are combined). 
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3.5 H Kenory Graph Disilay 

This mode is only available on output to the 340 display. 
It ehom a grapfi of actual core memory usage. Horizontal position 
represents absolute address and vertical position reprereents type 
of use. Words ure displayed on the left edge of the screen whicn 
describe the use opposite then. The occurance of a block of memory 
at reveral vertical positions represents a shared block. (See also 
mode H.J 

3.6 I Available l/C Devices 

The symbolic devices implemented in the ITS system in use 
are listed ty this mode. Output is repeated after a ten second 
delay. 

3.7 L Console Lines 

This mode simply outputs the system supplied directory for 
device 1TY. 

3.8 ft hemory Use List 

A display is provided by this mode of a31 of the uses to 
which actual core memory is being put. After ar> explanatory 
Keating line, one line is shown for each use in decreasing order by 
actual core memory occupied. 

£ach line beginr with the type of use, either the UNAME and 
J NAM of a procedure or a single descriptive word such as "FREE" 
fcr unused actual memory or "DSKBUF" for disk transfer buffers. A 
«#• is displayed just alter the names of a stopped job. After the 
type of use, ihe total number of actual core blocks dedicated to 
that use is listed followed (in the case of procedures) by: (1) 
the number of the highert virtual page riot in use in that 
procedure; (2) the number of its pages that are shared with some 
other procedure; (3) the number of its pages that are not in actual 
£»ejncry tut have *beer* swapped out; (4) the total number of page 
slots in use by the procedure; (5) the resources in use by the 
procedure (see section 4.1). 

3.9 N Normal faode 
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This is the initial and most commonly used information mode 
in 1HEK. 

2,9 •! The Top 

After the normal tot display lines (see section 1), N node 

diet lave one line of special information in the forft of several 

variable raises followed by their values. These names are as 
follows: 

HEM¥R££ Nunber of blocks of unused actual core meaory. 

USBBX Number of blocks of user variables currently 

allocated in the system. 

RNA£LU Number of runable usern (including the PEEK 
disjlaying it)* 

TRUhM Total tser memory blocks of active users. 

AUSOPC Number of active ucer swapped cut blocks (pages), 

3*9.2 Ihe Mddle 

After the special information listed in the section above, 
a beading line is displayed followed by one line of information per 
job. The tree structure of jobs is shown by the indentation of the 
flrrt few items after the user index number on each line. Top 
level console controlled, disowned, or rystem jobs are leftmost. 
Under each procedure apjearc its inferiors which are indented one 
sp*u.e, and its second level inferiors which are indented two 
spaces. 

The information appearing for each job is as follows: (1) 
the user index, UNAfrE, JNAM1*., and current system na&e; (2) the run 
staius, teletype status, and resources seized (see section 4); (3) 
the nuaber of blocks of memory in use by the jot and the number of 
such blocks that are swapped out; (4) the average percent of 
available machine time used recently by the job; (5) twe words of 
irosfible pending interrupts for the job; (6) the total amount of 
actual run time^ that har been used by the iob. The proceeding list 
applies to output to the line printer or 340 display (see section 
f>). Other outiut is atbreviated by dropping some of the 
infermation. In particular, the JoAME is dropped for top level 
non-disowned jobs aiid the UhAME dropped for their inferiors. 
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3.9-3 Ihe Bottom 

Space permitting , two lines of epecial information are 
outjut at the bottom of the h mode display* The first is a line of 
totals which fives the total memory in use by all listed jobs (no 
deduction is made for shared pafesj, the average total percent of 
machine time used recently by listed jobs, and the total run time 
used by all listed jobs. 

The last line shows the total amount of run time for all 
users that have logped out durinp the system run so far, the anount 
of machine time used by jobs killed by users who are still logged 
in, and the amount of run time for the null job* 

3-1C S Single r jree 

Thir mode outputs the same information in the same format 
as the ;. mooe except thfrt only jroceedures in a single job tree are 
included. Qhe L coumanc should be proceeded by the user index of a 
job in the tree to be displayed. If no argument is fiven the tree 
conlainine the IEEK will be displayed. 

3.11 T Translation Table 

The froj + and to device, system name, file noflies, and 
app^icatility oi the syrtem translation table entries are listed by 
this mode. 

2.1 1 U DEC Tape Channels 

This mode if similar to the C mode for disk except that it 
ajjiies to the DEC tape drives. In addition to listing information 
for oper. channels, it lists various infermation for each drive. 
Thir per drive information includes the directional motion status 
of the orive, the U;pe Hock to which the systeiu is trying to move 
it, and the current believec position oi the tape. Also listed for 
eaci drive is a directory pointer, the UNAMF of the user who la-rt 
caured a directory to ix read in for that drive, and the UNAKE of 
the user, ii any, to whom the drive is "assigned". 

If the directory pointer for a drive is -1 it means that 
the system is not retairing a directory for that drive and the tape 
can be safely flapped by hand. Otherwise, the directory pointer 
Cives the location in memory of the tape's directory. Even after a 
tape has been flapped aid no directory is being retained for it, 
thif mode displays the UNAME of the last job to cause a directory 
to te read in from that drive. 
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Z*Y: V Single irocedure Variables 

Many of the user variables for v single procedure csn be 
vieued with this mode« After showing the procedure's names, run 
status* and resources, the octal value of a number of named 
variables are displayed. Then, under a heading lino, the contents 
of the procedure's Acs, input-output channel words and input-output 
stalus words arc listed* For open channels* the device and mode 
symbol is also shown* 

3.14 X A/D and D/A Multiplexors 

This mode outputs the digitalization of all the multiplexed 
analog to digital input channels and the value beinc output at each 
of the multiplexed digital-to-analof channels. 

ZAl X DEC Tap* Directory 

This mode simply outrutf thf? r;ystem-supilied directory for 
a particular DEC tape- It should be preceded by a drive number. 

J. It ? Explanation Mode 

Thir mode outputs a list anri brief explanation cf PFEK'e 
com^andr* Output is repeated after a ten second delay. 
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4.0 Special Output Field Formats 

4-1 Resource Letters 

The following are the eyeteu, resource letters ufed in medes 
C t N, Hi S f and V explained above: 

6 The procedure has contrcl ol the PDP-6* 

B The procedure has control of the IBM compatible 
magnetic taje drive (MTO)* 

C The procedure is now using, or was the last to use 9 
the ITS core allocator. 

D The procedure has contrcl of the DEC 340 display (DIS). 

1 The procedure is in "lOT-user* node. This letter 

can be present for core than one procedure (.IOTLSR). 

L The procedure has control of the main line printer 

M The procedure has seized the master user facility 
(.MASTER), 

The procedure has contrcl of the old line printer 
(OLI). 

P The procedure has control of the CalComp plotter (PLT)* 

R The procedure has contrcl of the paper tape reader 

- (FIi<% 

S The procedure has contrcl of the Sylvania tablet (TAB). 

T The procedure has contrcl of the pep*r tape punch 

- (FTPf. 

V The procedure has contrcl of the vidisector (NVD). 
£ The procedure is in real ti*ie mode (.REALT). 

4-2 Process film Status 

The following sections explain the jrocedure rur status 
field output by modes G, N f S, and V: 
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4.2. 1 Irefix 

One of the follcwinf characters will appear at the 
beginning of the status code: 

> Svar blccket. This procedure is being "blocked fr-on 
run? ing by the swap scheduler to stop thrashing, 

_ Desired out. This procedure is not swap "blocked but 
the swaj scheduler has decided to swap it out, 

* PI is progress. This procedure is rot swap blocked or 
desired out but is processing a software interrupt. 

(Space) None of the above apply. 

4.2.2.1 Body If Stopped 

If a procedure is stopped* the tody of its status field is 
a number output in an ur usual format. The first twc octal dibits 
of ihe number are printed as an unsigned number, then an w !" is 
outjut, then the rest of the number with leading zeros js 
eliminated. The resulting; figure to the right of the "■!■ is the 
com t of transient reasons for the rrocedure to be stopped. If 
thi: count is persistently non-zero, an internal system error has 
prolably occured. 

In the figure tc the left of the "!*, the top four tits 
havt special meaning. The 40 and 20 bits are used ty the core 
cllc cater when it ie moving or modifyinf the core isage of 
procedures. The 10 bit is the most corinon and is the only bit 
dirtctly cortroDlable hj user procedure? to start and stop ether 
rroccdures. The 4 bit is used as a temjorary stop tit by seme 
sysiea calls* If the 40, 20* or 4 bits stay on persistently, there 
is jrobably something wrong. 

4.2-2.2 Body If Hung 

A procedure can be hung (execution temporarily tlocked) 
cither due to wtritir.g for a page of its core image to be swapped in 
or due to a wait for soke condition in the execution of a system 
call. 

In the case of a hung system call v PEEK simply displays the 
name of the system call or, for an input-output transfer, the 
device name and transfer type. If the procedure is blocked waiting 
for a p&fi' to be swapped in, the word "PAGE* is displayed, unless 
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the rage is needed to handle a software interrupt to the user in 
which case MPAGE" is displayed. 

4.2.2.5 W Eody If hunning 

If a procedure is running in user mode, the word "RUN" is 
displayed as the body of its status field. If it ii executing a 
syslem call, the sa&e word is displayed as if it were hune in that 
system call (see section 4.2.2.2) except that a °+ w is added in 
front. There are several reasons, however, that a procedure can be 
rum ing in executive code without having executed a normal system 
call, lor example, if the procedure has just exeexuted an illegal 
instruction, ">:>>:" will be displayed, and if it has just executed a 
UUO that will be reflected lack to it as a user UUO, the word "UUO" 
will be displayed. 

4.2.3 Uiffix 

Under some circumstances, a system call being executed by a 
procedure, 11 for example, will have to make sure that a second 
procedure, F£, is net running temporarily in executive mode. This 
bay necessitate P1 waitihg until P2 is interruptible if P2 is 
initially runnine in executive node. If PEFK is run during this 
waiting state, a u > u followed by the user index of P2 will appear 
at the end of the statur field for PI and a *<" followed by P1*s 
index correspondingly alter P2's status. Hiis situation is refered 
to ls PI PCLSRing (I-C-losering) P2. 

This state should be extremely transient. If you see this 
sufiix display even once, you should suspect some problem, 

4.3 Process Teletype Status 

The teletype status field displayed for a procedure will be 
one of the following five things: 

DISOWN The procedure is disowned and can not have a 
comole associated with it. 

Tn Th^ procedure is immediately controlling and being 
controlled ly "teletype" number n. 

> The procedure has assigned its teletype downward in 
its procedure tree. The number should be displayed by one of its 
inferior procedures. 
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< The procedure has had its console taken away by a 
higher level procedure. The number should be displayed by some 
other procedure in its jrocedure tree. 

? There is nc evidence oi a console ever beinp directly 

associated with the procedure (It night be a newly created 
inferior). 
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5.0 I/O Control 

PEEK has four different nodes of output (not to be confused 
with the information modes listed in section 3)- Two of these, 
which provide the nost verbose cutpjt, are intended for output to 
the line printer and the 340 display. The remaining two modes are 
for printing consoles (teletypes) and alpha-nuneric disjlay 
consoles (Datapoints). 

The exact information displayed for various information 
modes is afiecttd by this output mode. Especially for the more 
com] lex information modes, like N, there is an abbreviated version 
of the output for printing consoles* an intermediate one for alpha- 
numeric displays, ard a comjlete versior for the line printer and 
340 disjlays. In the descriptions of irforuition modes, usually 
the most complete output form was explained. 

PEEK starts in either the printing or alpha-numeric disjlay 
modes, depending on the nature of the user's console, unless it 
fines that the user's console is at a 340 screen or it cannot ojen 
device 3TY for output. In either oi these two cases it tries tc 
use the 340 disjlay outfut node (If the 340 disjlay is not tried, a 
flaj ir set which is cleared only by "Y which inhibits further 
attempts abusing the 340). The following commands can be used to 
charge FEEK's output mode: 

*"E This switches output to the line printer if it is 
available. If it is not available, the outjut device will be 
unchanged. 

fc E This ceamard releases the line printer if FEEK is 
usiig it. It then resets the output mode through the sane 
procedure used when PEEK is first started. 

"« This ccmrcard releases the 340 display, if PEEK is 
usirg it, and then it sets a flag which inhibits any PEEK attempt 
at t-cing the 340. This flap is cleared only by ~Y. Finally, PEEK 
charges to type out or alpha-numeric display mode. 

~X PEfc.K will try to seize the 340 display for outjtit en 
receipt of this command. If it succeeds, the output mode will be 
set to the 340. Otherwise, outrut will revert to the user's 
comole. In either case, the flag Eientioned under ~N above is 
cleared. 
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6.0 Miscellaneous Conmunds 

The following are miscellaneous PEEK commands: 

P This is the proceed command. 

If PEEK is running under a HACTRKj this command will 
return control of the urer'f console to HACTRM tut leave the PEJ.K 
runt. inc. If 34c display or line printer output is selected, it 
will continue* If the 1EEK is running as a top level job, this 
co in and will cause it tc logout. 

The P command utes .VALUE to return the string "rPRCCED » 
to lEEK's superior jrocedure. 

Q Thir is the quit cocjnanci. 

If PEEK is running under a HACTRM, this command will 
destroy the PEhh it is typed at and return control cf the user's 
cotuole to IIACTKAN. If the PEEK is running as a top level job, 
thic- coL.L.r.r.c will cause it to logout. 

The ccmmatd ur.es .VALUE to return the string ":KIIL n to 
PEEi/s superior procedure. 

Z Thir is the doze command. 

It teices a numeric argument and sets the standard 

update delay to that number of secords (see section 3)* 

(Space) This le a sort of null ©ode couand* It does 
not charge IEEK's information acde Vut causes it to turned lately 
Login updating the current cutjut. 
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